<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>截取字符串的部分</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.iconv-strrpos.html">iconv_strrpos</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.iconv.html">iconv</a></div>
 <div class="up"><a href="ref.iconv.html">iconv 函数</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.iconv-substr" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">iconv_substr</h1>
  <p class="verinfo">(PHP 5)</p><p class="refpurpose"><span class="refname">iconv_substr</span> &mdash; <span class="dc-title">截取字符串的部分</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-function.iconv-substr-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="type">string</span> <span class="methodname"><strong>iconv_substr</strong></span>
    ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$str</code></span>
   , <span class="methodparam"><span class="type">int</span> <code class="parameter">$offset</code></span>
   [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$length</code><span class="initializer"> = iconv_strlen($str, $charset)</span></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$charset</code><span class="initializer"> = ini_get(&quot;iconv.internal_encoding&quot;)</span></span>
  ]] )</div>

  <p class="para rdfs-comment">
   根据 <em><code class="parameter">offset</code></em> 和 <em><code class="parameter">length</code></em> 参数指定 <em><code class="parameter">str</code></em> 截取的部分。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.iconv-substr-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   <dl>

    
     <dt>
<em><code class="parameter">str</code></em></dt>

     <dd>

      <p class="para">
       原始字符串。
      </p>
     </dd>

    
    
     <dt>
<em><code class="parameter">offset</code></em></dt>

     <dd>

      <p class="para">
       如果 <em><code class="parameter">offset</code></em> 是非负数，<span class="function"><strong>iconv_substr()</strong></span> 从 <em><code class="parameter">str</code></em> 开头第 <em><code class="parameter">offset</code></em> 个字符开始截出部分，从 0 开始计数。
      </p>
      <p class="para">
       如果 <em><code class="parameter">offset</code></em> 是负数，<span class="function"><strong>iconv_substr()</strong></span> 从  <em><code class="parameter">str</code></em> 末尾向前 <em><code class="parameter">offset</code></em> 个字符开始截取。
      </p>
     </dd>

    
    
     <dt>
<em><code class="parameter">length</code></em></dt>

     <dd>

      <p class="para">
       如果指定了 <em><code class="parameter">length</code></em> 并且是正数，返回的值从 <em><code class="parameter">offset</code></em> 截取部分，最多包含 <em><code class="parameter">length</code></em> 个字符（取决于 <em><code class="parameter">string</code></em> 的长度）。
      </p>
      <p class="para">
       如果传入了负数的 <em><code class="parameter">length</code></em>，
       <span class="function"><strong>iconv_substr()</strong></span> 将从第 <em><code class="parameter">offset</code></em> 个字符到离末尾 <em><code class="parameter">length</code></em> 个字符截出 <em><code class="parameter">str</code></em> 的部分。
       如果 <em><code class="parameter">offset</code></em> 也是负数，则开始位置计算规则的解释见以上。
      </p>
     </dd>

    
    
     <dt>
<em><code class="parameter">charset</code></em></dt>

     <dd>

      <p class="para">
       如果省略了参数 <em><code class="parameter">charset</code></em>，<em><code class="parameter">string</code></em> 的编码被认定为 <a href="iconv.configuration.html" class="link">iconv.internal_encoding</a>。
      </p>
      <p class="para">
       注意，<em><code class="parameter">offset</code></em> 和 <em><code class="parameter">length</code></em> 参数总是被认为字符表现的偏移，基于 <em><code class="parameter">charset</code></em> 检测到的字符集进行统计计算，而相对应的 <span class="function"><a href="function.substr.html" class="function">substr()</a></span> 则是基于字节的位移来计算。
      </p>
     </dd>

    
   </dl>

  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.iconv-substr-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   返回 <em><code class="parameter">offset</code></em> 和 <em><code class="parameter">length</code></em> 参数指定的 <em><code class="parameter">str</code></em> 的部分。
  </p>
  <p class="para">
   如果 <em><code class="parameter">str</code></em> 比 <em><code class="parameter">offset</code></em> 字符数更短，将会返回 <strong><code>FALSE</code></strong>。
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.iconv-substr-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><span class="function"><a href="function.substr.html" class="function" rel="rdfs-seeAlso">substr()</a> - 返回字符串的子串</span></li>
    <li class="member"><span class="function"><a href="function.mb-substr.html" class="function" rel="rdfs-seeAlso">mb_substr()</a> - 获取字符串的部分</span></li>
    <li class="member"><span class="function"><a href="function.mb-strcut.html" class="function" rel="rdfs-seeAlso">mb_strcut()</a> - 获取字符的一部分</span></li>
   </ul>
  </p>
 </div>


</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.iconv-strrpos.html">iconv_strrpos</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.iconv.html">iconv</a></div>
 <div class="up"><a href="ref.iconv.html">iconv 函数</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
